home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / util / cdity / mcxprefs2_5.lha / MultiCXPrefs / MultiCXPrefs.doc < prev    next >
Text File  |  1995-10-07  |  17KB  |  463 lines
  1. ------------------------------------------------------------------------
  2.                             MultiCX Prefs v2.5
  3. ------------------------------------------------------------------------
  4.  
  5.                  MultiCX Prefs and this documentation are
  6.                  Copyright ⌐ 1995 by Michael Barsoom M.D.
  7.  
  8. ------------------------------------------------------------------------
  9.                                   License
  10. ------------------------------------------------------------------------
  11.  
  12. MultiCX Prefs may be freely distributed as long as no charge is made other
  13. than to cover time and copying costs.  If it is to be distributed via
  14. floppy disk, this cost should be no higher than $3.00 (three) dollars US.
  15. If distribution is via CDRom, the total cost should be no more than $25.00
  16. (twenty-five) dollars US.
  17.  
  18. You may not copy and/or distribute this program without the accompanying
  19. documentation unless you get permission from the author to do so.  Fred
  20. Fish and AmiNet already have my permission to include this program on their
  21. CDRom collections.
  22.  
  23. You may not disassemble, decompile, re-source or otherwise reverse engineer
  24. the program.  If you wish to incorporate parts of this program into other
  25. programs, write to the author to ask for permission.
  26.  
  27. Finally if you wish to include MultiCX Prefs on a disk magazine you are
  28. REQUIRED to get the author's permission FIRST.  Usually this will require
  29. you to just send me a copy of the issue which contains MultiCX Prefs free
  30. of charge.
  31.  
  32. I reserve the right to publically poke fun at anyone who fails to abide by
  33. these distribution rules, along with more severe action if appropriate.
  34.  
  35. Martin Berndt has my permission to distribute MultiCX Prefs with MultiCX.
  36.  
  37. AmigaFormat is forbiden to include MultiCX Prefs on any of their cover
  38. disks.
  39.  
  40. ------------------------------------------------------------------------
  41.                                 Disclaimer
  42. ------------------------------------------------------------------------
  43.  
  44. This product is sold "as is" without representation or warranty of any
  45. kind, either expressed or implied.  The user assumes all risks and
  46. responsibilities related to its use.
  47.  
  48. ------------------------------------------------------------------------
  49.                                Requirements
  50. ------------------------------------------------------------------------
  51.     1- Workbench 2.0+
  52.     2- gtlayout.library v18.1+ (included)
  53.        Copyright ⌐ by Olaf `Olsen' Barthel
  54.     3- MultiCX (obviously)
  55.        Copyright ⌐ by Martin Berndt
  56.  
  57.     4- WBStart-Handler (included)
  58.        optional - required only to use the "Start MultiCX" menu item
  59.        Copyright ⌐ by Stefan Becker
  60.  
  61. ------------------------------------------------------------------------
  62.                                    Usage
  63. ------------------------------------------------------------------------
  64.  
  65. Usage is pretty self explanatory.  Each of the gadgets corresopond to one
  66. of MultiCX tooltypes.  Please see MultiCX docs for explaination of each.
  67.  
  68. When you click on "Test" the current config is saving to the MultiCX icon
  69. so you can try it out.  If you then select "Quit" or "Cancel" then old
  70. configuration will be restored in the MultiCX icon, that is if you have not
  71. saved it.  The test gadget will only be active if MultiCX is running.
  72.  
  73. Note 1:  All unknown tooltypes in the icon will be restored when you save
  74. your prefs.  This will allow you to use newer version of MultiCX without
  75. loosing the tooltypes for the new options that MultiCX prefs does not know
  76. yet.
  77.  
  78. Note 2:  MultiCX prefs will automatically add the ExtPrefs tooltype.  This
  79. will contain the path for MultiCX and your preference for WarnChanges.
  80.  
  81. Note 3:  Starting with MultiCX prefs v2.5, you will only get one warning
  82. that your need to upgrade.  However to do this a new tooltype will be
  83. created in the MultiCX icon.  This feature is not automatic, if you wish to
  84. not be reminded again you HAVE to save the prefs.
  85.  
  86. ------------------------------------------------------------------------
  87.                                Configuration
  88. ------------------------------------------------------------------------
  89.  
  90. MultiCXPath                (tooltype or shell)
  91.     By default MultiCX Prefs will load the prefs for the currently running
  92.     copy of MultiCX.  If for some reason you are not running MultiCX, then
  93.     MultiCX Prefs will load the icon specified with this tooltype.  Remember
  94.     to specify the full path of the icon including its name with or without
  95.     the .info.
  96.     default SYS:WBStartup/MultiCX
  97.  
  98. WarnChanges=<YES|NO>    (tooltype or shell)
  99.     Tells MultiCX Prefs not to put up the warning requester if you have
  100.     changed the current config.  This option can also be changed by
  101.     toggling the "Warn Changes" menu item.
  102.     default YES
  103.  
  104. ------------------------------------------------------------------------
  105.                        Bugs, Suggestions, 'payments'
  106. ------------------------------------------------------------------------
  107. you can reach me at the following,
  108.  
  109. snail Mail
  110.     Michael Barsoom
  111.     40 Scott Drive
  112.     Bloomfield CT 06002
  113.     USA
  114.  
  115. Internet:  barsoom@netcom.com
  116.            mbars@bluejay.creighton.edu
  117.            
  118. -----BEGIN PGP PUBLIC KEY BLOCK-----
  119. Version: 2.6.2
  120.  
  121. mQBtAy6fxzEAAAEDAMO9QIMT9WpFUuvUPIMP5HNIKEhoQKj9I9Xwe9UToT8X/KAu
  122. N3XUmwGhbyi6xI6HwZ7SmiiBiXahoaPz5UJhdOebNwJC5P5/eqgDyFfeCH8v0Wv8
  123. rUVegS1Y8sQsgimu0QAFEbQkTWljaGFlbCBCYXJzb29tIDxiYXJzb29tQG5ldGNv
  124. bS5jb20+tC1NaWNoYWVsIEJhcnNvb20gPG1iYXJzQGJsdWVqYXkuY3JlaWdodG9u
  125. LmVkdT4=
  126. =R1W2
  127. -----END PGP PUBLIC KEY BLOCK-----
  128.  
  129. ------------------------------------------------------------------------
  130.                                   Thanks
  131. ------------------------------------------------------------------------
  132.  
  133. Special thanks to:
  134.  
  135. Mario Cattaneo
  136.     for beta testing, and helping find and fix many bugs.
  137.  
  138. Olaf `Olsen' Barthel
  139.     for gtlayout.library and helping me with me many questions.
  140.     
  141. Any person mentioned in this docs need not send me anything for 'payment'
  142. you have already done enough in helping produce this program.
  143.  
  144. ------------------------------------------------------------------------
  145.                                   History
  146. ------------------------------------------------------------------------
  147.  
  148. -----------------------------------------------------------
  149. Version 2.5                             (01.10.95 22:04:04)
  150. -----------------------------------------------------------
  151.  
  152.      - Now you will only get one warning if either MCX or MCXPrefs
  153.        needs to be updated (instead of every time MCXPrefs is
  154.        run)
  155.  
  156.  
  157. -----------------------------------------------------------
  158. Version 2.4                             (28.09.95 19:45:30)
  159. -----------------------------------------------------------
  160.  
  161.      - Added AlertTime
  162.  
  163.  
  164. -----------------------------------------------------------
  165. Version 2.3                             (27.09.95 07:32:25)
  166. -----------------------------------------------------------
  167.  
  168.      - Added support for NoDisplayBeep, IOAlert, and NoBootWrite
  169.  
  170.  
  171. -----------------------------------------------------------
  172. Version 2.2                             (26.09.95 06:19:39)
  173. -----------------------------------------------------------
  174.  
  175.      - Opaque functions are no longer disabled when run under
  176.        WorkBench 2.x
  177.  
  178.  
  179. -----------------------------------------------------------
  180. Version 2.1                             (13.09.95 04:47:54)
  181. -----------------------------------------------------------
  182.  
  183.      - Added AvoidWindow
  184.  
  185.  
  186. -----------------------------------------------------------
  187. Version 2.0                             (10.09.95 06:55:40)
  188. -----------------------------------------------------------
  189.  
  190.      - Added Opaqe Window functions
  191.  
  192.  
  193. ------------------------------------------------------------
  194. Version 1.16                            (26.08.95 08:17:55)
  195. ------------------------------------------------------------
  196.  
  197.      - Added ShapeClicker support
  198.  
  199.      - Added ResetHandler
  200.  
  201.      - Now all devices are listed, not just the ones in memory.
  202.  
  203.  
  204. ------------------------------------------------------------
  205. Version 1.16                            (22.08.95 21:07:13)
  206. ------------------------------------------------------------
  207.  
  208.      - Now all devices are listed, not just the ones in memory.
  209.  
  210.  
  211. ------------------------------------------------------------
  212. Version 1.15                            (22.08.95 18:53:08)
  213. ------------------------------------------------------------
  214.  
  215.      - Moved CLI stuff to another page
  216.  
  217.      - Added support for ShapeFreezer, NoFormat, LockPatch.
  218.  
  219.  
  220. ------------------------------------------------------------
  221. Version 1.14                            (15.08.95 20:38:32)
  222. ------------------------------------------------------------
  223.  
  224.      - Added support for NewLookProp.
  225.        Changed ForceNewLook to NewLookMenus
  226.  
  227.  
  228. ------------------------------------------------------------
  229. Version 1.13                            (17.07.95 17:21:42)
  230. ------------------------------------------------------------
  231.  
  232.      - Added LockPens and FixOpenWB
  233.  
  234.      - Fixed small bug where AssignWedge and PatchDisable tooptypes
  235.        got placed in the icon several times
  236.  
  237.  
  238. ------------------------------------------------------------
  239. Version 1.12                            (12.07.95 17:55:46)
  240. ------------------------------------------------------------
  241.  
  242.      - Now requires gtlayout library v18+
  243.  
  244.      - Added support for newer semaphore.
  245.  
  246.      - Added  WBTitle, WBAbout
  247.  
  248.  
  249. ------------------------------------------------------------
  250. Version 1.11                            (02.07.95 19:07:42)
  251. ------------------------------------------------------------
  252.  
  253.      - Added AssignWedge
  254.  
  255.      - Added ForceNew look and second screen page.  ForceNew look 
  256.        will be inactive when run with Kick 2.x.
  257.  
  258.      - Reset to defaults had no effect on MapUmlauts, EditHook,
  259.        and NoCcapsLock (fixed)
  260.  
  261.      - Added support for HardPatch, SA_Pens, SA_AutoScroll,
  262.        SA_Font, and Patch_Disable.
  263.  
  264.      - Added support for EditHook
  265.  
  266.  
  267. ------------------------------------------------------------
  268. Version 1.10                            (06.06.95 21:34:42)
  269. ------------------------------------------------------------
  270.  
  271.      - I has been brought to my attention the gtlayout.library
  272.        include with MultiCX Prefs does not work with a processor
  273.        lower than and '020.  I am attempting to get this problem
  274.        fixed, but have been unable to do so as of now.
  275.  
  276.      - Added support for CDUNBLANK
  277.  
  278.      - Added support for AutoCenter
  279.  
  280.      - Slight change the the MultiCX launch code.  Fixes problem of
  281.        pathname being too long.
  282.  
  283.      - Added DisplayBeep warning if MultiCX could not be started.
  284.  
  285.  
  286. -----------------------------------------------------------
  287. Version 1.9                             (25.05.95 23:49:27)
  288. -----------------------------------------------------------
  289.  
  290.      - If run using asl.library v37, "picker" gadget for screenmode
  291.        will not be present.
  292.  
  293.      - Added support for LockPubFlags
  294.  
  295.  
  296. -----------------------------------------------------------
  297. Version 1.8                             (24.05.95 09:23:38)
  298. -----------------------------------------------------------
  299.  
  300.      - Added menuitem "Start MultiCX".  To use this feature you
  301.        need to have WBStart-Handler installed in L:
  302.  
  303.  
  304. -----------------------------------------------------------
  305. Version 1.7                             (23.05.95 21:19:06)
  306. -----------------------------------------------------------
  307.  
  308.      - One could not toggle the "Warn Changes" menu item when
  309.        running on WB 3.x. (fixed)
  310.  
  311.  
  312. -----------------------------------------------------------
  313. Version 1.6                             (23.05.95 15:24:09)
  314. -----------------------------------------------------------
  315.  
  316.      - MultiCX was not running the preference editor as a backround
  317.        process, so MultiCX Prefs will now include a "RUN" in the
  318.        EXTPREFS tooltype.  This should solve the problem of some
  319.        of MultiCX's hotkeys not working, while MultiCX Prefs is
  320.        running.       Reported by by Mario Cattaneo
  321.  
  322.  
  323. -----------------------------------------------------------
  324. Version 1.5                             (22.05.95 14:23:52)
  325. -----------------------------------------------------------
  326.  
  327.      - Will now periodically monitor to see if MultiCX is still
  328.        running and appropriately disable/enable the "Test" gadget
  329.        and "Quit (Prefs and MultiCX)" menu item
  330.        Requested by Mario Cattaneo
  331.  
  332.      - Opps, was saving CX_POPKEY tooltype as CX_POPUP (fixed)
  333.  
  334.  
  335. -----------------------------------------------------------
  336. Version 1.4                             (21.05.95 08:05:52)
  337. -----------------------------------------------------------
  338.  
  339.      - Added "Warn Changes" menu item, under the "Options" menu
  340.  
  341.      - Will now automatically add the tooltype "ExtPrefs"
  342.  
  343.      - Added support for BackCycle hotkey.
  344.  
  345.  
  346. -----------------------------------------------------------
  347. Version 1.3                             (19.05.95 19:08:29)
  348. -----------------------------------------------------------
  349.  
  350.      - Added "Quit (MultiCx & Prefs)" menu item
  351.  
  352.      - Added protection to prevent prefs from being run more than
  353.        once.  Now if you run it again it will cause the already
  354.        running one to pop its window to the front.
  355.  
  356.      - Added HotFlush and CX_PopKey
  357.  
  358.  
  359. -----------------------------------------------------------
  360. Version 1.2                             (19.05.95 09:06:47)
  361. -----------------------------------------------------------
  362.  
  363.      - Now if you are testing a config, and open a different config
  364.        the old config will be restored to the icon prior to loading
  365.        the new config.
  366.  
  367.      - Put back MCXPath tooltype. Now if MultiCX prefs is running,
  368.        MCXPrefs will load its icon, otherwise it will load the icon
  369.        specified in the tooltype.
  370.  
  371.  
  372. -----------------------------------------------------------
  373. Version 1.1                             (18.05.95 20:36:02)
  374. -----------------------------------------------------------
  375.  
  376.      - Removed window close gadget, as prefs editors should not
  377.        have them
  378.  
  379.      - Added support for reading location of MultiCX icon from
  380.        MultiCX semaphore.  This feature requires v1.69 of MCX.
  381.  
  382.      - Code which was saving all unknown tooltypes would prevent
  383.        certain options from being disabled. (fixed)
  384.        Reported by Mario Cattaneo
  385.  
  386.      - Prefs window in now an appwindow, you can now just drop your
  387.        MultiCX prefs icon on the window and it will be
  388.        automatically loaded.
  389.  
  390.      - Added incrementer arrow buttons to PopCLI stack.
  391.  
  392.      - Added TDRetry, TDStep, TDSettle, TDCalibrate
  393.  
  394.      - Added AvoidTask and AvoidScreen
  395.  
  396.      - Removed DONOTWAIT as it is no longer needed.
  397.  
  398.      - All unknown tooltypes will now be saved back into the icon.
  399.        Requested by Martin Berndt
  400.  
  401.      - Added page menu, for faster access to config pages.
  402.  
  403.      - Increased number of configuration pages
  404.        Editor will now fit on a standard Hi-Res NTSC screen
  405.  
  406.      - Added MAPUMLAUTS, CENTERSCR and SNDFILTER
  407.  
  408.  
  409. -----------------------------------------------------------
  410. Version 1.0                             (09.05.95 12:50:08)
  411. -----------------------------------------------------------
  412.  
  413.      - Forgot version string (fixed)
  414.  
  415.      - Added tooltype "WARNCHANGES", you can now disable the
  416.        requester notifying you that you have made changes to the
  417.        current config.
  418.        Requested by Mario Cattaneo
  419.  
  420.      - If no valid config exist's in memory selecting save will
  421.        bring up a file requester so you can select which icon to
  422.        save the config in.
  423.  
  424.      - If MultiCX icon fails to open, "Test" gadget & "Last Saved"
  425.        menu item will be diabled.
  426.        Requested by Mario Cattaneo
  427.  
  428.      - Now requires gtlayout.library v15.1, fixes problem with
  429.        PopCLIStack being lost if the "Misc" page was not the
  430.        front most.
  431.  
  432.      - Now uses memory pools.
  433.  
  434.      - Replaced menuitem "Use" and replaced it with "Test" gadget
  435.        requested by Mario Cattaneo
  436.  
  437.      - Will no longer fail to open icon, if you included the
  438.        trailing .info in the MCXPath tooltype.
  439.        reported by Mike Krings
  440.  
  441.      - New icon, thanks to Troy "Doogie" Davis for sending it to me.
  442.  
  443.  
  444. ------------------------------------------------------------
  445. Version 0.91                            (24.04.95 13:11:13)
  446. ------------------------------------------------------------
  447.  
  448.      - Added DONOTWAIT option
  449.        requested by Mario Cattaneo
  450.  
  451.      - Blank time was not being displayed correctly (fixed)
  452.  
  453.      - Added CDNOBLANK option for MultiCX v1.62
  454.  
  455.  
  456. ------------------------------------------------------------
  457. Version 0.90                            (12.04.95 14:43:08)
  458. ------------------------------------------------------------
  459.  
  460.        --- Initial release ---
  461.  
  462.  
  463.